package com.example.spring.Mapper;

import com.example.spring.entity.User;
import org.apache.ibatis.annotations.*;

import java.util.List;

/**
 * 用户数据访问接口
 * 使用MyBatis注解方式定义SQL操作
 * 处理与user表相关的所有数据库操作
 */
@Mapper
public interface UserMapper {
    /**
     * 插入新用户记录
     * @param user 用户对象
     */
    @Insert("insert into user(username,password,name,phone,email,address,avatar) values(#{username},#{password},#{name},#{phone},#{email},#{address},#{avatar})")
    public void insertUser(User user);

    /**
     * 更新用户信息
     * @param user 包含更新数据的用户对象
     */
    @Update("update user set username=#{username}, password=#{password}, name=#{name},phone=#{phone},email=#{email},address=#{address},avatar=#{avatar} where id=#{id}")
    public void updateUser(User user);

    /**
     * 根据ID删除用户
     * @param id 用户ID
     */
    @Delete("delete from user where id=#{id}")
    public void deleteOne(Integer id);

    /**
     * 查询所有用户，按ID降序排列
     * @return 所有用户列表
     */
    @Select("select * from user order by id desc")
    public List<User> selectAll();

    /**
     * 根据ID查询单个用户
     * @param id 用户ID
     * @return 用户对象
     */
    @Select("select * from user where id=#{id}")
    public User selectById(Integer id);

    /**
     * 根据用户名和姓名精确查询用户
     * @param username 用户名
     * @param name 姓名
     * @return 满足条件的用户列表
     */
    @Select("select * from user where username=#{username} and name=#{name}")
    public List<User> selectByMore(String username, String name);

    /**
     * 根据用户名和姓名模糊查询用户
     * @param username 用户名(模糊匹配)
     * @param name 姓名(模糊匹配)
     * @return 满足条件的用户列表
     */
    @Select("select * from user where username like concat('%', #{username}, '%') and name like concat('%', #{name}, '%')")
    public List<User> selectLike(String username, String name);

    /**
     * 分页查询用户
     * @param skipNum 跳过的记录数
     * @param pageSize 每页记录数
     * @param username 用户名(模糊匹配)
     * @param name 姓名(模糊匹配)
     * @return 当前页的用户列表
     */
    @Select("select * from user where username like concat('%', #{username}, '%') and name like concat('%', #{name}, '%') limit #{skipNum}, #{pageSize}")
    public List<User> selectByPage(Integer skipNum, Integer pageSize, String username, String name);

    /**
     * 统计满足条件的用户总数
     * @param username 用户名(模糊匹配)
     * @param name 姓名(模糊匹配)
     * @return 满足条件的记录总数
     */
    @Select("select count(id) from user where username like concat('%', #{username}, '%') and name like concat('%', #{name}, '%')")
    public Integer selectCount(String username, String name);

    /**
     * 根据用户名查询用户
     * 用于登录验证和注册检查用户名是否已存在
     * @param username 用户名
     * @return 用户对象，如果不存在则返回null
     */
    @Select("select * from user where username=#{username}")
    public User selectByUsername(String username);
}
